メインコンテンツまでスキップ

ユーザーログエラー対応ガイド

SHIELD Gate 統合ログ中ユーザーログイベントがWARNまたはERRORレベルで記録されたときの意味と対応手順を整理した顧客用運用ガイドです。


目次


1. 概要

1.1 ログレベルの区分

レベル意味
INFO正常動作または一般イベント記録。別途措置不要。
WARNサービス利用に直接的な影響はないが、点検の価値がある状況。
ERROR機能の実行に失敗しました。原因の確認と対応が必要です。

1.2 このガイドの範囲

  • このガイドはユーザーログの中でERROR レベルが発生する可能性のあるイベントに限定して詳細対応を説明します。
  • 常にINFOロマン記録されるイベント一覧は5.1 付録参照。

2. ユーザーログイベントの概要

以下の表は SHIELD Gate ユーザーログの全イベントとERRORレベル発生可能かどうかを整理したものです。

分類イベントコードイベント名ERROR 発生対応セクション
認証CALLBACK_SECURITY365_CODEログイン⚠️ (※1)
POST_SIGN_OUTログアウト3.1
POST_RELAY_TOKENサービス移動3.1
NAVIGATE_TO_ADMIN_PAGE管理者ページに移動
隔離ブラウザPOST_INQUIRY_WORK_ITEM_ACCESS_URLブラウザ接続
RBI_URL_CHANGEDブラウザ接続後移動
RBI_CHECK_INPUT_TEXTユーザー入力の機微情報検査
RBI_CLIPBOARD_ACCESS_RB2PC隔離ブラウザでコピー
RBI_CLIPBOARD_ACCESS_PC2RB隔離ブラウザに貼り付け
RBI_USAGE_ERROR隔離ブラウザエラー3.6 / 4
RBI_SESSION_TIMEOUT隔離ブラウザセッションタイムアウト
RBI_KEYBOARD_INPUTキーボード入力のブロック
パーソナライズPOST_FAVORITE_ITEMお気に入り登録3.2
DELETE_FAVORITE_ITEMお気に入りの削除3.2
ファイルRBI_FILE_UPLOADファイルアップロード3.4
RBI_FILE_DOWNLOADファイルダウンロード3.5
RBI_FILE_VIEWER_REQUESTSHIELD Viewer リクエスト
上部バーGET_EXTERNAL_INTERFACE_ACCESS_URL上部バー外部リンク接続3.3

※1 CALLBACK_SECURITY365_CODE 案内
ログインイベントはログインに成功した場合のみ記録されます。ログイン失敗自体はユーザー情報を確定できないため、別途ERRORログに残りません。ログイン失敗が繰り返される場合はSOFTCAMPにお問い合わせください。


3. ERROR発生イベント別対応ガイド

表内の「担当」表記規約
사용자— 再ログイン・再試行・環境確認などで自分が解決可能な範囲
고객사 관리자— 政策·権限·ファイアウォール·DNS·証明書など顧客の運用領域で点検·設定で解決可能な範囲
대상 사이트 측— 隔離ブラウザでアクセスする外部ウェブサイトの責任範囲
소프트캠프— サービス内部の問題と判断されるため、問い合わせが必要な範囲


3.1 POST_SIGN_OUT / POST_RELAY_TOKEN (ログアウト / サービス移動)

🔧 責任区分の要約 — 소프트캠프 영역
このイベントのERRORサービス内部の問題のみで発生します。顧客側設定によって引き起こされるケースはなく、顧客側の対応項目なしですぐに SOFTCAMP にお問い合わせください対象です。

項目内容
イベントPOST_SIGN_OUT— SHIELD Gate ログアウトPOST_RELAY_TOKEN— Security365 管理センターから SHIELD Gate 管理者ページに移動
一般的な性格サービス内部の問題のみで発生。ユーザー/顧客の設定から引き起こされるケースはありません。

3.1.1 発生可能な原因

#原因担当
1内部データストレージ一時障害SOFTCAMP
2認証サービス連携エラーSOFTCAMP

3.1.2 推奨措置

  1. **[ユーザー]**再ログイン後、同じ作業を再試行してください。
  2. **[顧客会社管理者]**同じタイムゾーンの他のユーザーにも同じエラーが発生したか確認する(インフラ系の問題判断)
  3. 同じ症状が続く場合はSOFTCAMP お問い合わせ

3.2 POST_FAVORITE_ITEM / DELETE_FAVORITE_ITEM (お気に入り登録 / 削除)

🔧 責任区分の要約 — 소프트캠프 영역
このイベントのERRORサービス内部データストレージの問題によってのみ発生します。顧客側の措置項目なしでSOFTCAMPへの問い合わせ対象です。

項目内容
イベントPOST_FAVORITE_ITEM— お気に入り登録DELETE_FAVORITE_ITEM— お気に入り削除
一般的な性格サービス内部データストレージの問題で主に発生。

3.2.1 発生可能原因

#原因担当
1内部データストレージ接続エラーSOFTCAMP
2その他のサービス内部例外SOFTCAMP

3.2.2 推奨措置

  1. **[ユーザー]**しばらくして再試行
  2. 繰り返し発生時SOFTCAMP お問い合わせ

3.3 GET_EXTERNAL_INTERFACE_ACCESS_URL (トップバー外部リンク接続)

🔧 責任区分の要約 — 고객사 관리자 1차 점검
1次で顧客管理者の上部バー外部リンク設定を確認。設定が正常にもかかわらず発生する場合は、SOFTCAMPに問い合わせてください。

項目内容
イベント管理者がユーザーページの上部バーに設定したカスタムボタンをユーザーがクリックして外部URLにアクセスする動作

3.3.1 発生可能原因

#原因担当備考
1上部バーの外部リンクが設定されていない状態で呼び出し顧客会社管理者管理者ページのUIで事前にブロックされるため、通常は発生しません。
2内部データストレージの取得エラーSOFTCAMP

3.3.2 推奨措置

  1. **[顧客会社管理者]**管理者ページ > 上部バー設定で該当のカスタムボタンが正常に登録されているか確認
  2. 設定が正常にもかかわらず繰り返し発生する場合SOFTCAMP お問い合わせ

3.4 RBI_FILE_UPLOAD (ファイルアップロード)

🔧 責任区分の要約 — 외부 사이트 / 사용자 환경 1차 점검
ほとんどのケースはアップロード対象サイト側の問題またはユーザーPCのネットワーク環境の問題が 1順位 原因。SHIELD Drive 関連 失敗のみ 権限・認証 確認後 SOFTCAMP 問い合わせ 対象。

隔離ブラウザを通じたファイルアップロード過程で発生するERRORログです。アップロードパスによって原因が異なるため、以下の4つのケースに分けて説明します。

3.4.1 [ケース A] ローカル PC → 隔離ブラウザで接続したサイトのアップロード

ユーザーが隔離ブラウザで開かれたサイトにローカルファイルを添付してアップロードする際に発生。

#発生原因担当確認方法
1アップロード対象サイトサーバーの異常応答(サイト一時障害、認証期限切れ、ファイルサイズ/形式ポリシー違反など)対象サイト側ユーザーが対象サイトに直接アクセスして同じファイルをアップロード詩にも同様の症状か比較
2ネットワーク切断 / CORS / DNS失敗によるリクエスト自体の失敗ユーザー / 顧客管理者ユーザーPCのネットワーク状態、VPN接続、ファイアウォールポリシーの確認
3対象サイトがJSONではない形式で応答 (HTMLエラーページなど)対象サイト側対象サイト側の問題の可能性が高い

推奨措置

  1. ユーザーPCから対象サイトに直接アクセスし、同じファイルのアップロードが正常かどうかを比較
  2. 直接接続も失敗する場合 → 対象サイト側の問題と判断
  3. 直接接続は正常ですが、隔離ブラウザでのみ失敗する場合 →SOFTCAMP お問い合わせ

3.4.2 [ケース B] SHIELD Drive ファイル → 隔離ブラウザサイト (SHIELD Drive ファイルのインポートステップ失敗)

ユーザーが SHIELD Drive ダイアログでファイルを選択して隔離ブラウザサイトにアップロードする時、SHIELD Driveで元のファイルを取得するステップで失敗。

#発生原因担当措置
1SHIELD Drive 認証が期限切れまたはトークンが無効ですユーザーログアウト後再ログイン
2ユーザーにそのファイルへのアクセス権がありません顧客会社管理者ファイル/フォルダのアクセス権限を付与
3ファイルはSHIELD Driveから既に削除されたか移動されましたユーザーSHIELD Driveでファイルの存在確認後再試行
4SHIELD Drive サービス内部エラーSOFTCAMPSOFTCAMP お問い合わせ

3.4.3 [ケース C] SHIELD Drive ファイル → 隔離ブラウザサイト (対象サイトアップロード段階失敗)

ケースBと同じ流れですが、SHIELD Driveでファイルを正常に取得した後隔離ブラウザで接続したサイトにアップロードする段階で失敗。

#発生原因担当確認方法
1対象サイトサーバーの異常応答対象サイト側ユーザーが対象サイトに直接アクセスして同じ症状か比較
2ネットワーク切断またはCORSエラー顧客会社管理者ネットワーク / ファイアウォールポリシーの確認

3.4.4 [ケース D] 複数ファイルアップロード (非同期失敗)

ローカルファイルまたはSHIELD Driveファイルを一度に複数アップロードする際、一部のファイルのアップロード応答処理段階で失敗。

  • 原因・措置基準はケース Aと同じ
  • 特定のファイルだけが繰り返し失敗するのか、全体が一斉に失敗するのかを区別して確認

3.5 RBI_FILE_DOWNLOAD (ファイルダウンロード)

🔧 責任区分の要約 — 혼합 (SHIELD Drive 저장은 관리자 영역 비중 큼)
ダウンロードポリシートリガー失敗(ケースA)とSHIELD Driveアップロードネットワーク失敗(ケースB)はSOFTCAMP 処理領域. SHIELD Drive 保存中 応答エラー(ケース C)はほとんど顧客管理者のストレージ / 権限 / 拡張子ポリシー設定領域。

隔離ブラウザを通じたファイルダウンロード過程で発生するERRORログです。ダウンロード保存位置(ローカルPC / SHIELD Drive)と失敗地点に応じて、以下の3つのケースに分けます。

3.5.1 [ケース A] ダウンロードポリシートリガー失敗

ユーザーが隔離ブラウザサイトでファイルダウンロードボタンをクリックすると、SHIELD Gateバックエンドのダウンロードポリシー処理ステップで失敗。

#発生原因担当
1SHIELD Gate サーバー内部エラー (一時ファイル生成失敗、データストレージエラーなど)SOFTCAMP
2隔離ブラウザコンテナからファイルを受け取る段階のエラーSOFTCAMP
3分類されていない例外SOFTCAMP

推奨措置

  1. **[ユーザー]**同じファイルの再ダウンロードを試みる
  2. 他のファイルは正常にダウンロードされるが、特定のファイルだけが繰り返し失敗する場合は、そのファイルの情報とともにSOFTCAMP お問い合わせ

3.5.2 [ケース B] SHIELD Drive ストレージへのダウンロード — ネットワーク / HTTP 例外

SHIELD Driveを使用する環境で、隔離ブラウザサイトのダウンロードファイルをSHIELD Driveに保管する流れ中SHIELD Drive アップロード API 呼び出し自体が失敗場合。

#発生原因担当
1SHIELD Gate サーバー / 孤立ブラウザコンテナファイル処理エラーSOFTCAMP
2サーバーダウン、タイムアウトなどの一時的なネットワーク例外SOFTCAMP

推奨措置

  1. **[ユーザー]**しばらくして再試行
  2. 同じ時間帯に多数のユーザーが同じ症状を経験する場合 → インフラ的な問題の可能性
  3. 繰り返し発生時SOFTCAMP お問い合わせ

3.5.3 [ケース C] SHIELD Drive ストレージへのダウンロード — 応答ビジネスコード失敗

ケースBと同じ流れですが**API 呼び出しは成功しましたが、SHIELD Drive 側の応答が異常です。**の場合。

#発生原因担当措置
1SHIELD Drive ストレージが作成されていません顧客会社管理者SHIELD Drive ストレージの作成
2SHIELD Gateが該当ストレージにアクセス権限がありません顧客会社管理者ストレージアクセス権限設定
3ファイル名が SHIELD Drive の命名規則に違反していますユーザーファイル名を変更して再試行してください
4ユーザーストレージ容量超過顧客会社管理者ファイル整理または容量増設
5SHIELD Driveが該当の拡張子を未サポート / ブロック顧客会社管理者SHIELD Drive 拡張子ポリシー確認
6ファイルストレージ連携サービスのアップロード失敗SOFTCAMPSOFTCAMP お問い合わせ
7SHIELD Drive 内部アップロード処理失敗SOFTCAMPSOFTCAMP お問い合わせ
8SHIELD Driveに会社またはユーザー情報がありません顧客会社管理者ユーザー プロビジョニング 状態 確認
9ストレージ情報の取得に失敗しましたSOFTCAMPSOFTCAMP お問い合わせ
10SHIELD Drive ストレージ無効状態顧客会社管理者ストレージの有効化
11SHIELD Drive ストレージアップロード権限なし顧客会社管理者アップロード権限付与
12空のファイル(0バイト)のダウンロードを試みましたユーザー原本ファイルの確認
13その他の分類されていない例外SOFTCAMPSOFTCAMP お問い合わせ

推奨措置

  1. 管理者設定系統(1·2·5·8·10·11)はまず設定を確認・補完
  2. 設定正常後にも発生する場合SOFTCAMP お問い合わせ

3.6 RBI_USAGE_ERROR (隔離ブラウザエラー)

隔離ブラウザ使用中に発生したシステムエラーをすべて包含するイベントです。errorDetail値によって具体的な原因が区別され、詳細な分類と対応は4章 RBI_USAGE_ERROR 詳細コードガイドを参照してください。


4. RBI_USAGE_ERROR 詳細コード (errorDetail) 対応ガイド

RBI_USAGE_ERRORイベントとともに記録されるerrorDetailフィールドで具体的な原因を特定します。分類体系は次の8つのグループです。

グループ分類主要な性格1次責任領域
Aコンテナ / セッションの作成・割り当てに失敗しましたRBI リソース割り当て段階ユーザー(タブ制限)またはSOFTCAMP
Bセッション進入 / 検証失敗ユーザーセッション状態異常ユーザー再入場 → 繰り返し時SOFTCAMP
Cポリシー照会 / 判定失敗ポリシーサービス連携SOFTCAMP(FAILED_NAVIGATED_PAGEは対象サイトを含みます)
Dコンテナ接続状態ランタイム接続切断管理者の措置結果またはSOFTCAMP
Eヘルスチェック失敗隔離ブラウザインスタンス起動状態顧客管理者(ファイアウォール/DNS)+ ソフトキャンプ
Fブラウザ環境ユーザーPCのChromeバージョンユーザー / 顧客管理者(アップデートポリシー)
Gクローム ネットワーク レイヤー エラー隔離ブラウザ → 外部サイト区間顧客管理者(ネットワーク・セキュリティチェック) / 対象サイト側
H基本値 (Fallback)分類不可例外SOFTCAMP

💡 運用のヒント
G グループはユーザー数が増えるほど比重が最も大きくなるグループであり、ほとんどの顧客のネットワーク・セキュリティ機器の点検で1次解消が可能します。チェックリスト(4.8.2)をまず実行した後も解消されないものはSOFTCAMPに問い合わせると対応が早くなります。

4.1 全体errorDetailインデックス

グループerrorDetail一行要約
AFAILED_CREATING_CONTAINER隔離ブラウザコンテナ生成API呼び出し失敗
AERROR_GET_CONTAINER_URLコンテナ URL 取得失敗 (分類外例外の代表コード)
AERROR_GET_CONTAINER_URL_REASSIGNコンテナ URL 再割り当て パス 失敗
AMAXIMUM_PODS_REACHED隔離ブラウザクラスタの容量超過
AMAXIMUM_TABS_REACHEDユーザー/テナント同時オープンタブ制限超過
BNO_TAB_ID_SESSIONセッション識別子なしまたはマッピングなし (異常なエントリ)
BMISSING_SESSION_DATAセッションコンテキストなし(期限切れ / 不一致)
BMISSING_CURRENT_URL隔離対象URLが空です
CPOLICY_QUERY_FAILEDポリシーサーバーの取得に失敗しました
CFAILED_NAVIGATED_PAGE許可されたURLですが、実際のページ移動に失敗しました
DCONTAINER_DISCONNECTED隔離ブラウザコンテナのリアルタイム接続切断
DSESSION_TERMINATED_BY_ADMIN管理者がセッションを強制終了
EHEALTH_CHECK_NETWORK_ERROR隔離ブラウザインスタンス到達失敗 (TCP/TLS)
EHEALTH_CHECK_TIMEOUT隔離ブラウザインスタンスヘルスチェック応答遅延
FBROWSER_VERSION_UPDATE_REQUIREDChromeの最小バージョン未満
GERR_TIMED_OUT全体リクエストタイムアウト
GERR_NETWORK_CHANGEDネットワーク切り替え (Wi-Fi ↔ LAN, VPN再接続)
GERR_CONNECTION_CLOSED送受信中に接続が終了しました
GERR_CONNECTION_RESETサーバー/パス機器がRSTを送信
GERR_CONNECTION_REFUSED対象ポートはリッスンしていません
GERR_CONNECTION_ABORTED接続異常終了 (クライアントの観点)
GERR_CONNECTION_FAILED一般接続失敗
GERR_NAME_NOT_RESOLVEDDNSの照会に失敗しました
GERR_INTERNET_DISCONNECTEDクライアント インターネット接続なし
GERR_SSL_PROTOCOL_ERRORTLS ハンドシェイク失敗
GERR_ADDRESS_INVALID誤ったIP / ホスト表記
GERR_ADDRESS_UNREACHABLEルーティング上到達不可
GERR_SSL_CLIENT_AUTH_CERT_NEEDEDmTLS クライアント証明書要求
GERR_TUNNEL_CONNECTION_FAILEDHTTP CONNECT プロキシトンネリング失敗
GERR_NO_SSL_VERSIONS_ENABLED利用可能な TLS バージョンがありません
GERR_SSL_VERSION_OR_CIPHER_MISMATCHTLS バージョン / 暗号スイート交渉失敗
GERR_CONNECTION_TIMED_OUTTCP接続確立タイムアウト
GERR_PROXY_CONNECTION_FAILED設定されたプロキシ接続に失敗しました
GSSL_CERTIFICATE_ERRORサーバー証明書の有効性エラー
GERR_CERT_AUTHORITY_INVALID発行CA信頼不可
GERR_EMPTY_RESPONSEサーバーが応答なしに接続を終了しました
HUNKNOWN_SYSTEM_ERROR分類不可 / マッピングされていないすべての例外のデフォルト値

4.2 A. コンテナ / セッションの作成・割り当て失敗

errorDetail原因担当
FAILED_CREATING_CONTAINER隔離ブラウザコンテナ生成API呼び出し自体が失敗。主に内部管理サービスの一時障害、認証の期限切れ、バックエンドの例外。SOFTCAMP
ERROR_GET_CONTAINER_URLコンテナ URL 取得ステップの代表的なエラーコード。具体的な原因が別途分類されていないほとんどの例外がこの値に集約される。SOFTCAMP
ERROR_GET_CONTAINER_URL_REASSIGN既存のコンテナが異常であるため新しいコンテナに再割り当てを試みている途中で失敗。SOFTCAMP
MAXIMUM_PODS_REACHED隔離ブラウザクラスター全体の収容能力上限に達しました。新しいコンテナの割り当てが拒否されました。SOFTCAMP
MAXIMUM_TABS_REACHEDユーザー(またはテナント)ごとに同時オープンタブの制限超過。新しいタブの作成ステップでブロック。ユーザー

推奨措置

  • MAXIMUM_TABS_REACHED: ユーザーに使用していないタブを閉じるように案内
  • MAXIMUM_PODS_REACHED: 容量増設協議必要 — SOFTCAMP問い合わせ
  • それ以外のAグループコード: 持続再発時にSOFTCAMPに問い合わせ

4.3 B. セッションの開始 / 検証失敗

errorDetail原因
NO_TAB_ID_SESSIONセッション識別子(tabId)がないか、クライアントセッションストレージにマッピングがない異常なエントリー. ブックマーク / 直接リンクを開く、親ウィンドウなしで隔離されたブラウザページを直接開く場合など。
MISSING_SESSION_DATAセッション識別子はありますが、一致するセッションコンテキスト(ユーザー/ポリシー/対象URLなど)がありません。セッションの有効期限後の再入場またはサーバー-クライアントの状態不一致。
MISSING_CURRENT_URL隔離ブラウザに移動する対象URLが空です。進入経路パラメータが欠落しているか、親ウィンドウからのURLの伝達に失敗しました。

推奨措置

  1. **[ユーザー]**管理者ページ/ユーザーページ正常進入経路で再接続
  2. 正常経路で繰り返し発生する場合SOFTCAMP お問い合わせ

4.4 C. 政策の照会 / 判定

errorDetail原因担当
POLICY_QUERY_FAILEDポリシーサーバーの照会API失敗(ネットワーク / 5xx / パースエラー)。ブロック・許可の判定自体が不可能な状態でページ接続がブロックされています。SOFTCAMP
FAILED_NAVIGATED_PAGE政策上許可で判定されましたが、実際のページ移動が失敗しました。隔離ブラウザ内部ナビゲーションの失敗またはリダイレクトループなど。対象サイト側 / SOFTCAMP

推奨措置

  • POLICY_QUERY_FAILEDが全ユーザーに同時発生: サービス内部の問題 → 直ちに SOFTCAMP に問い合わせ
  • FAILED_NAVIGATED_PAGE特定のサイトでのみ発生: 該当サイトのリダイレクション/認証構造を確認

4.5 D. コンテナ接続状態 (ランタイム)

errorDetail原因
CONTAINER_DISCONNECTED使用中の隔離ブラウザコンテナとのリアルタイム接続が切断されました。サーバー側コンテナの終了、ネットワークの断絶、keep-aliveの失敗など。
SESSION_TERMINATED_BY_ADMIN管理者が中央管理コンソールで該当ユーザーセッションを強制終了. 再接続は試みず、画面が非アクティブになります。

推奨措置

  • SESSION_TERMINATED_BY_ADMIN: 正常期待動作 — 管理者の措置の結果
  • CONTAINER_DISCONNECTED: ユーザー再接続後も繰り返し発生する場合は SOFTCAMP にお問い合わせください

4.6 E. ヘルスチェック失敗

隔離ブラウザインスタンスの状態確認ステップでの失敗です。一般的なパスではWARNレベルで記録されて通過しますが、特定の進入条件ではERRORページに昇格されます。

errorDetail原因
HEALTH_CHECK_NETWORK_ERROR隔離ブラウザインスタンスまでTCP / TLSレベル到達失敗。ファイアウォール / ウェブフィルター / ネットワークDLPブロック、DNS失敗、クライアントオフライン、証明書問題の可能性。
HEALTH_CHECK_TIMEOUTインスタンスは生きている可能性がありますが、ヘルスチェック応答が2秒に達していません。インスタンスの起動遅延、ノードの過負荷、ネットワークRTTの急増。

推奨措置

  1. **[顧客会社管理者]**社内ファイアウォール / ウェブフィルター / DNS設定でSHIELD Gateドメインがブロックされていないか確認
  2. **[ユーザー]**VPN / セキュリティエージェント再起動後再試行
  3. 同一タイムゾーンで多数のユーザーに再現される場合、インフラ系の問題 → SOFTCAMPに問い合わせ

4.7 F. ブラウザ環境

errorDetail原因
BROWSER_VERSION_UPDATE_REQUIREDユーザーが使用しているChromeのバージョンがサポートされている最小バージョンを下回っています。隔離ブラウザ機能に必要なWebView APIがないため、アップデート要求画面に切り替わります。

推奨措置

  • ユーザーにChromeの更新通知 (自動更新をブロックするポリシー環境では管理者が更新を許可する必要があります)

4.8 G. クロームネットワーク層エラー

隔離ブラウザ → 外部対象ウェブサーバー区間でChromiumが返したエラーコードをそのまま記録した項目です。

この区間のエラーはユーザーPC ↔ SHIELD Gateではなく隔離ブラウザクラスター ↔ 対象サイト区間で発生します。点検は隔離ブラウザ側のegressネットワークと対象サイト側のingressポリシーを優先します。

4.8.1 エラーコードマッピング

Chrome codeerrorDetail主要な原因
-7ERR_TIMED_OUT全体リクエストタイムアウト。遅いサーバー / パス。
-21ERR_NETWORK_CHANGEDネットワーク切り替え (Wi-Fi↔LAN, VPN再接続)。
-100ERR_CONNECTION_CLOSEDサーバーがデータ送受信中に接続終了。
-101ERR_CONNECTION_RESETサーバー / 中間機器のRST送信。L4機器・プロキシで強制切断。
-102ERR_CONNECTION_REFUSED対象ポートがリッスンしていません。サービスダウンまたはポートタイプミス。
-103ERR_CONNECTION_ABORTED異常な接続終了 (クライアントの視点)。
-104ERR_CONNECTION_FAILED一般接続失敗。詳細分類不可能なL4問題。
-105ERR_NAME_NOT_RESOLVEDDNS照会に失敗しました。ドメインが存在しないか、DNSサーバーに問題があります。
-106ERR_INTERNET_DISCONNECTEDクライアントのインターネット接続がありません。
-107ERR_SSL_PROTOCOL_ERRORTLS ハンドシェイク失敗。
-108ERR_ADDRESS_INVALID不正なIP/ホスト表記。
-109ERR_ADDRESS_UNREACHABLEルーティング上の目的地到達不可。
-110ERR_SSL_CLIENT_AUTH_CERT_NEEDEDサーバーがクライアント証明書を要求 (mTLS)。
-111ERR_TUNNEL_CONNECTION_FAILEDHTTP CONNECT プロキシトンネリングに失敗しました。
-112ERR_NO_SSL_VERSIONS_ENABLED使用可能なTLSバージョンがありません。
-113ERR_SSL_VERSION_OR_CIPHER_MISMATCHTLSバージョン / 暗号スイート交渉失敗。
-118ERR_CONNECTION_TIMED_OUTTCP接続確立タイムアウト。ファイアウォールドロップ、ルーティング失敗の疑い。
-130ERR_PROXY_CONNECTION_FAILED設定されたプロキシ接続に失敗しました。
-200SSL_CERTIFICATE_ERRORサーバー証明書の有効性エラー (包括)。
-202ERR_CERT_AUTHORITY_INVALID発行CAの信頼性がありません。プライベートCAがインストールされていないなど。
-324ERR_EMPTY_RESPONSEサーバーが何の応答も返さずに接続を終了しました。

4.8.2 顧客管理者チェックリスト

以下のエラーは隔離ブラウザクラスター → 対象ウェブサーバー間の隔離環境のegress区間で発生します。ユーザーPC → SHIELD Gate区間ではなく、隔離ブラウザクラスター側のネットワーク / ポリシーを優先的に確認してください。

① DNS 解釈失敗 (ERR_NAME_NOT_RESOLVED)
  • 隔離ブラウザクラスターに設定されたDNSサーバー(社内 / 外部)の応答正常性確認
  • 対象ドメインが社内DNSにのみ存在する場合、隔離ブラウザクラスターでも同じDNSを参照しているか確認してください。
  • 顧客環境のドメインブロックポリシー(DNSシンクホール、カテゴリブロック)に引っかかっていないか確認
  • 特定のドメインだけが失敗するのか、全体のドメインが失敗するのかを隔離ブラウザ内の他のサイトで比較テスト
② ネットワークタイムアウト / 到達失敗 (ERR_TIMED_OUT, ERR_CONNECTION_TIMED_OUT, ERR_CONNECTION_FAILED, ERR_ADDRESS_UNREACHABLE)

隔離ブラウザ側 (Outbound)

  • 隔離ブラウザクラスタが位置するネットワークで対象サーバーIP/ポートへのアウトバウンドファイアウォールの許可状況を確認
  • クラスター egress 区間の NAT GW / プロキシ / SD-WAN ルーティングの正常性確認
  • 隔離ブラウザノードのCPU / メモリ / ネットワークRTT指標確認(過負荷による処理遅延の可能性)

対象サイト側 (Inbound)

  • 対象サイトの inbound ファイアウォール / セキュリティグループ で隔離ブラウザクラスター egress IP がブロックされていないか確認
  • 対象サイトがIPホワイトリストポリシーを運営中の場合、隔離ブラウザクラスターのegress IPが登録されているか確認してください。
  • GeoIP / 国別ブロックポリシーに隔離ブラウザクラスターリージョンがかかっていないか確認(海外リージョン使用時に頻繁)
  • クラウド WAF(Cloudflare / Akamai など) IP 評判 / ボットブロックポリシーに egress IP が捕捉されていないか確認 (多数のユーザートラフィックが単一 IP に集中し評判が低下する可能性)
  • 対象サーバーの同時接続数 / Rate-Limit閾値に達したか確認

比較テスト

  • ユーザーPCで同じサイトが直接接続されているか比較 → 直接接続も失敗した場合は対象サーバー / インターネット回線の問題
  • 他の隔離ブラウザノード(他のegress IP)で同じサイト接続比較 → 特定のIPブロックの有無識別
③ 接続拒否 / 強制終了 (ERR_CONNECTION_CLOSED, ERR_CONNECTION_RESET, ERR_CONNECTION_REFUSED, ERR_CONNECTION_ABORTED)
  • 対象のウェブサーバー / サービス自体が正常に稼働しているか確認 (ERR_CONNECTION_REFUSEDは通常サービスダウンを意味します)
  • 経路上の L4 / WAF / IPS 機器が隔離ブラウザの egress トラフィックを自動的に遮断 (RST 送出) していないか確認
  • 対象サイトで短時間に大量リクエストによるRate-Limitブロックの有無確認(多数ユーザー → 単一出発地に見える)
  • クライアント User-Agent / TLS フィンガープリントに基づくブロック(ボット検出)ポリシーの有無確認
④ インターネット接続 / ネットワーク切替 (ERR_INTERNET_DISCONNECTED, ERR_NETWORK_CHANGED)
  • 隔離ブラウザクラスターのインターネット回線 / NAT GW / egress IPの正常性確認
  • 同じタイムゾーンの他のユーザーにも同じエラーが発生したか確認 (全体に影響がある場合はインフラの問題)
  • ERR_NETWORK_CHANGEDはクライアントPC側のネットワーク切り替えでも発生する可能性があります → ユーザー回線(VPN再接続、Wi-Fi ↔ LANスイッチング)を同時に確認してください。
⑤ TLS / SSL 交渉失敗 (ERR_SSL_PROTOCOL_ERROR, ERR_NO_SSL_VERSIONS_ENABLED, ERR_SSL_VERSION_OR_CIPHER_MISMATCH)
  • 対象サイトが要求するTLS最小バージョン(例:TLS 1.2 / 1.3)が隔離ブラウザポリシーと互換性があるか確認してください。
  • 古いバージョンのサイト(TLS 1.0 / 1.1のみサポート)への接続時のセキュリティポリシーに基づく許可の可否の検討
  • 経路上のSSLインスペクションデバイスが交渉失敗を引き起こさないか確認する
⑥ サーバー証明書エラー (SSL_CERTIFICATE_ERROR, ERR_CERT_AUTHORITY_INVALID)
  • 対象サイトの証明書の有効期限 / ドメイン不一致 / 自己署名の有無確認
  • 社内の私設CAで発行されたサイトであれば、SHIELD Gateに私設CA証明書の登録状態を確認
⑦ クライアント証明書の要求 (ERR_SSL_CLIENT_AUTH_CERT_NEEDED)
  • 対象サイトがmTLS(相互認証書)を要求しているか確認
  • 隔離ブラウザ環境のクライアント証明書注入(ノードマウント / ポリシー配布)構成の有無検討
  • mTLSサイトの場合、隔離ブラウザの使用自体がポリシー上不適切である可能性があります → 例外処理(直接接続の許可)を検討
⑧ プロキシ / トンネリング失敗 (ERR_TUNNEL_CONNECTION_FAILED, ERR_PROXY_CONNECTION_FAILED)
  • 隔離ブラウザクラスタに設定されたアウトバウンドプロキシ (PAC / 明示的プロキシ) の正常動作確認
  • プロキシ認証情報(アカウント / トークン)の有効期限確認
  • 対象サイトがHTTPS CONNECTトンネリングをブロックしていないか確認
⑨ 誤った住所表記 (ERR_ADDRESS_INVALID)
  • ユーザーが入力したURL形式のエラーの有無(ポート番号、特殊文字)
  • 隔離ブラウザの進入経路パラメータのエンコーディング / デコーディング過程の損傷の有無
⑩ 空の応答 (ERR_EMPTY_RESPONSE)
  • 対象サーバーがリクエスト受信直後に応答なしで接続を切断する状態 → ネットワークまたは対象サイトの問題を確認する必要があります
共通点検
  • 同じエラーが特定のサイトにのみ発生 → サイト(またはサイトポリシー)に問題が絞られる
  • 同じエラーが複数のサイトで同時発生 → 隔離ブラウザインフラ / egress回線の問題
  • 同じエラーが特定のユーザーにのみ発生 → 該当ユーザーのポリシー / グループ / ルーティングポリシーを確認
  • 発生時刻の隔離ブラウザノード状態(ヘルスチェック、コンテナ再起動イベント)を確認する

4.9 H. デフォルト値 (Fallback)

errorDetail原因
UNKNOWN_SYSTEM_ERRORA~Gのいずれの分類にも該当しない例外の基本値。原因が特定されていないすべてのケース。

実質的にこの値に帰結する追加ケース:

  1. ヘルスチェックが HTTP / 分類不可 エラーを返した場合
  2. Chromium エラーコードマッピングにないコードが渡された場合
  3. セッションエラー処理ロジックの基本分岐

推奨措置

  • 該当コードが頻繁に集計される場合、分類拡張が必要な信号であるため、発生時刻・ユーザー・対象URLを収集してSOFTCAMPに伝達

5. 付録

5.1 ERROR レベルが発生しないイベント

次のイベントは設計上INFOレベルでのみ記録され、ERRORは残りません。

NAVIGATE_TO_ADMIN_PAGE          管理者ページに移動  
POST_INQUIRY_WORK_ITEM_ACCESS_URL ブラウザ接続
RBI_URL_CHANGED ブラウザ接続後に移動
RBI_CHECK_INPUT_TEXT ユーザー入力の敏感情報検査
RBI_CLIPBOARD_ACCESS_RB2PC 隔離ブラウザ → ローカルPCコピー
RBI_CLIPBOARD_ACCESS_PC2RB ローカルPC → 隔離ブラウザ貼り付け
RBI_SESSION_TIMEOUT 隔離ブラウザセッションタイムアウト
RBI_KEYBOARD_INPUT キーボード入力ブロック
RBI_FILE_VIEWER_REQUEST SHIELD Viewerリクエスト

5.2 SOFTCAMPへの問い合わせ時に伝える情報

問題解決にかかる時間を短縮するために、SOFTCAMPに問い合わせる際は以下の項目を一緒に伝えてください。

#項目備考
1発生時刻 (YYYY-MM-DD HH:MM:SS, タイムゾーンを含む)正確な時刻範囲必須
2会社識別子 / テナント名
3影響を受けたユーザー ID (またはメールアドレス)単一ユーザー / 複数かどうかも 함께
4イベントコード例:RBI_USAGE_ERROR
5errorDetailRBI_USAGE_ERRORの場合は必須
6対象URL (該当する場合)隔離ブラウザで接続していたサイトのアドレス
7再現の有無 / 再現ステップ再現された場合の段階的記録
8ユーザー ブラウザ / OS バージョンブラウザ環境の問題(Fグループ)区分用
9同じタイムゾーンの他のユーザーにも発生するかどうかインフラ性イシュー判断資料
10直前の管理者設定変更の有無ポリシー / ストレージ / ファイアウォール変更履歴